> ## Documentation Index
> Fetch the complete documentation index at: https://docs.driver.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Acquire a browser

> Take a ready browser. From here on the session belongs to the workspace like any other; the pool warms a replacement. Its createdAt is when the browser was warmed.



## OpenAPI

````yaml /api-reference/openapi.json post /v1/browser/pools/{poolId}/acquire
openapi: 3.0.0
info:
  version: 1.0.0
  title: Driver API
  description: API for interacting with the Driver.dev browser network.
  contact:
    name: Driver support
    email: alex@driver.dev
servers:
  - url: https://api.driver.dev
    description: Production
security: []
tags:
  - name: Sessions
  - name: Profiles
  - name: Account
  - name: Extensions
  - name: Pools
externalDocs:
  url: https://docs.driver.dev
  description: Driver documentation
paths:
  /v1/browser/pools/{poolId}/acquire:
    post:
      tags:
        - Pools
      summary: Acquire a browser
      description: >-
        Take a ready browser. From here on the session belongs to the workspace
        like any other; the pool warms a replacement. Its createdAt is when the
        browser was warmed.
      parameters:
        - schema:
            type: string
            minLength: 6
            maxLength: 80
            example: pool_8ca73065e49d44f3a7825743745b2948
          required: true
          name: poolId
          in: path
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties:
                waitMs:
                  type: integer
                  minimum: 0
                  maximum: 30000
                  default: 0
                  description: >-
                    How long to wait for a browser to become ready when none is,
                    in milliseconds (0 to 30000). Send {} for no wait; the body
                    is required.
              additionalProperties: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  poolId:
                    type: string
                    minLength: 6
                    maxLength: 80
                    example: pool_8ca73065e49d44f3a7825743745b2948
                  leaseId:
                    type: string
                  acquiredAt:
                    type: string
                  expiresAt:
                    type: string
                  session:
                    type: object
                    properties:
                      sessionId:
                        type: string
                        description: >-
                          The session id: an opaque string; do not validate its
                          format.
                      status:
                        type: string
                      servedBy:
                        type: string
                      createdAt:
                        type: string
                      stoppedAt:
                        type: string
                        nullable: true
                      cdpUrl:
                        type: string
                        nullable: true
                      note:
                        type: string
                        nullable: true
                    required:
                      - sessionId
                      - status
                      - servedBy
                      - createdAt
                      - stoppedAt
                      - cdpUrl
                      - note
                required:
                  - poolId
                  - leaseId
                  - acquiredAt
                  - expiresAt
                  - session
        '400':
          description: Invalid request
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error
        '404':
          description: Pool not found
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error
        '409':
          description: >-
            No browser became ready within waitMs ("No browser is currently
            ready in this pool"), or the pool is paused.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error
        '503':
          description: Browser service unavailable
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error
      security:
        - Bearer: []
components:
  securitySchemes:
    Bearer:
      type: http
      scheme: bearer
      description: >-
        A workspace API key from Settings → API keys in the dashboard
        (https://app.driver.dev), sent as a bearer token.

````