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

# Get Bearer Access Token

> Syteca ACB REST API endpoint to exchange Client ID / Client Secret for a short-lived Access Token. The first call every API consumer makes using Syteca version 7.28 or later.

Exchanges Client ID and Client Secret for a short-lived Access Token. This is the **first** call every ACB API consumer makes using Syteca 7.28+ — the returned Access Token authenticates subsequent calls to other endpoints. When the Access Token expires, call this endpoint again with the same Client ID and Client Secret.

### Where to get the Client ID / Client Secret

The Client ID / Client Secret comes from the **Application Account Settings** section of a Management Tool user — see [Set up user account](https://syteca.com/docs/api/acb/setup-user-account.md#configure-client-id-and-client-secret).

### Rate limit

API requests authenticated with Client ID / Client Secret are rate limited **per Client ID**, not per secret or per token. Every request made with the same Client ID counts toward one quota, no matter how many Client Secrets or active Access Tokens the account holds.

### Errors

See [Status codes](https://syteca.com/docs/api/acb/api-reference.md#status-codes). Common errors:

* **400 Bad Request** — Missing grant\_type, client\_id/client\_secret or grant\_type is not `client_credentials`.
* **401 Unauthorized** — invalid, rotated Client Secret or Client Secret doesn’t match the Client ID. Verify Client ID and Client Secret, and check whether the user's [external-app toggle](https://syteca.com/docs/api/acb/setup-user-account.md#what-happens-when-the-toggle-is-disabled) was disabled.
* **403 Forbidden** — the request originates from an IP not in the user's IP Address restriction.

## Related

> [card] [Set up user account](https://syteca.com/docs/api/acb/setup-user-account.md)
>
> Where to get the Client ID / Client Secret.

> [card] [API reference](https://syteca.com/docs/api/acb/api-reference.md)
>
> Status codes, rate limiting, conventions.

> [card] [Migrate to Client ID / Client Secret Authentication](https://syteca.com/docs/api/acb/migrate-to-client-credentials.md)
>
> Migrate from Refresh Token to Client Credentials flow.


## OpenAPI

````yaml POST /api/token
openapi: 3.0.3
info:
  title: Application Credentials Broker API
  description: >-
    API for managing secrets and folders in the Application Credentials Broker
    system
  version: 1.4.0
  contact:
    name: API Support
    email: support@example.com
servers:
  - url: https://your-syteca-host/SytecaACB
    description: On-premises Syteca ACB service (v1.2 or later)
    variables:
      hostname:
        default: your-syteca-host.example.com
        description: Your Syteca Application Server hostname
  - url: https://your-syteca-host/EkranACB
    description: Legacy URL prefix for ACB deployments updated from pre-v1.2
    variables:
      hostname:
        default: your-syteca-host.example.com
        description: Your Syteca Application Server hostname
security:
  - AccessTokenAuth: []
paths:
  /api/token:
    post:
      tags:
        - Authentication
      summary: Exchange Client ID / Client Secret for Access Token
      description: >-
        Endpoint to exchange a Client ID / Client Secret for a short-lived
        Access Token. First call every ACB consumer makes using Syteca version
        7.28 or later.
      requestBody:
        required: true
        content:
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/GetBearerTokenRequest'
      responses:
        '200':
          description: Access Token issued successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetBearerAccessTokenResponse'
        '400':
          description: >-
            Missing grant_type, client_id/client_secret or grant_type is not
            client_credentials
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Invalid Client ID / Client Secret or expired, rotated Client Secret
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: IP Address restriction blocks the request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security: []
components:
  schemas:
    GetBearerTokenRequest:
      type: object
      required:
        - grant_type
        - client_id
        - client_secret
      properties:
        grant_type:
          type: string
          enum:
            - client_credentials
          description: OAuth 2.0 grant type.
        client_id:
          type: string
          description: >-
            Client ID from the user's Application Account Settings in the
            Management Tool.
        client_secret:
          type: string
          description: >-
            Client Secret from the user's Application Account Settings in the
            Management Tool, which is shown once after adding it.
    GetBearerAccessTokenResponse:
      type: object
      properties:
        access_token:
          type: string
          description: >-
            Access Token to use on subsequent API calls (Authorization header
            for new endpoints).
        token_type:
          type: string
          description: >-
            Access Token Type to use on subsequent API calls (Authorization
            header for new endpoints).
        expires_in:
          type: integer
          format: int32
          description: Seconds until the Access Token expires. Default 900. Minimum 60.
    ErrorResponse:
      type: object
      properties:
        status:
          type: integer
          description: HTTP status code
        message:
          type: string
          description: Error message
      required:
        - status
        - message
  securitySchemes:
    AccessTokenAuth:
      type: apiKey
      in: header
      name: Authorization
      description: Access token for authentication

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.