REreplo
Api-keys

Mint a Replo API key with repository scopes. type user (the default) follows your live access to every project, for a coding agent such as Codex or Claude Code; type project reaches only projectIds, for CI or automation. Requires the api_keys.write scope when called with an API key.

Changed on

Beta — this endpoint may change before general availability.

post/api-keys

Request

  • Base URL
    https://api.replo.app/v1
  • Auth
    HTTP bearer

Headers

Replo-Api-Version'2026-10-29' required

The public API version to use for this request.

Request body

workspaceIdstring uuid required
namestring required
type'user' | 'project'

Which access the key carries. user (default): every project you can access, following your live workspace role; pick it for a coding agent working on your behalf, such as Codex or Claude Code. project: only the projects in projectIds; pick it for CI or automation that should touch named projects and nothing else.

projectIdsstring[] nullable required

Projects a project key can reach; you must be able to manage each one. Required for type project. Null for type user, which reaches every project you can access.

scopesstring[] required

Repository scopes: repo.read to clone and pull, add repo.write to push.

expiresInDaysinteger nullable required

Days until the key expires (1–366). User keys must expire; null makes a project key last until revoked.

Response

Mint a Replo API key with repository scopes. type user (the default) follows your live access to every project, for a coding agent such as Codex or Claude Code; type project reaches only projectIds, for CI or automation. Requires the api_keys.write scope when called with an API key.

object'api_key' required
idstring uuid required
namestring required
tokenPrefixstring required
workspaceIdstring uuid required
type'user' | 'project' required

Which access the key carries. user (default): every project you can access, following your live workspace role; pick it for a coding agent working on your behalf, such as Codex or Claude Code. project: only the projects in projectIds; pick it for CI or automation that should touch named projects and nothing else.

projectIdsstring[] nullable required

Projects a project key can reach, or null for a user key, which follows your access to every project.

scopesstring[] required
secretstring required
createdAtstring required
expiresAtstring nullable required

Expiry timestamp, or null when the key never expires.

Changes

  • 53d194ba2067Revision changes
    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

  • 666c31ceb45cRevision changes
    • breaking

      added the new required request property

    • breaking

      added the new required request property

    • breaking

      removed the enum value 2026-10-05 from the header request parameter Replo-Api-Version

    • breaking

      removed the required property from the response with the status

    • warning

      removed the request property

    • info

      added the new optional request property

    • info

      added the new enum value 2026-10-29 to the header request parameter Replo-Api-Version

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status