---
title: "Upload Certificate"
method: POST
path: "/v1/certificates"
tags: ["Certificates"]
---

# Upload Certificate

`POST /v1/certificates`

## Request

- Base URL: `https://api.anchorbrowser.io`
- URL: `https://api.anchorbrowser.io/v1/certificates`
- Auth: API key in header `anchor-api-key`

Upload a CA certificate to trust in browser sessions. Certificates are managed at the team level.
Once uploaded, reference the certificate by name when creating sessions to trust services using that CA.

See [CA Certificates documentation](/advanced/ca-certificates) for more details.

## Request body `multipart/form-data`

- object
  - `name` string, required: Unique identifier for the certificate (alphanumeric, hyphens, underscores only, 1-255 characters)
  - `file` string, binary, required: Certificate file (.crt, .pem, .cer, or .der format)
  - `description` string: Optional description of the certificate (max 1000 characters)

## Response `200`

Certificate uploaded successfully

- CertificateResponse
  - `data` CertificateResponseSchema
    - `id` string, uuid: Unique identifier for the certificate
    - `name` string: Certificate name (used to reference in sessions)
    - `description` string, nullable: Optional description of the certificate
    - `createdAt` string, date-time: Timestamp when the certificate was uploaded

## Other responses

- `400`: Invalid request - missing file, invalid name format, or unsupported file type
- `409`: A certificate with this name already exists for your team
- `500`: Unable to upload certificate

## Changes

- **2026-10-16** `b3bfdb98c79e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/anchorbrowser/apis/anchorbrowser-api/changes/v1/certificates/post.md)

---

[API](https://skmtc.dev/anchorbrowser/apis/anchorbrowser-api.md) - [All operations](https://skmtc.dev/anchorbrowser/apis/anchorbrowser-api/llms.txt) - [OpenAPI document](https://skmtc.dev/anchorbrowser/apis/anchorbrowser-api/revisions/9d755f22df0e?raw)