---
title: "POST /v1/organizations/{organizationId}/projects/{projectId}/pki/providers"
method: POST
path: "/v1/organizations/{organizationId}/projects/{projectId}/pki/providers"
tags: ["PKI"]
---

# POST /v1/organizations/{organizationId}/projects/{projectId}/pki/providers

`POST /v1/organizations/{organizationId}/projects/{projectId}/pki/providers`

## Request

- Base URL: `https://api.golioth.io`
- URL: `https://api.golioth.io/v1/organizations/{organizationId}/projects/{projectId}/pki/providers`
- Auth: API key in header `x-api-key` and API key in header `Authorization`

## Path parameters

- `organizationId` string, required
- `projectId` string, required

## Request body

- GoliothProviderConfig
  - `aws` GoliothAWSProviderOptions
    - `accessKey` GoliothAWSAuthOptionsAccessKey
      - `accessKeyId` string
      - `secretAccessKey` string
    - `region` string
    - `webIdentity` GoliothAWSAuthOptionsWebIdentity
      - `roleArn` string: ARN for the AWS IAM Role the Golioth PKI Service should assume.

## Response `200`

A successful response.

- GoliothAddProviderResponse
  - `data` GoliothProvider
    - `aws` GoliothAWSProviderOptionsResponse
      - `accessKey` string
      - `region` string
      - `webIdentity` GoliothAWSAuthOptionsWebIdentity
        - `roleArn` string: ARN for the AWS IAM Role the Golioth PKI Service should assume.
    - `createdAt` string, date-time
    - `id` string
    - `updatedAt` string, date-time

## Other responses

- `default`: An unexpected error response.

## Changes

- **2026-03-04** `a2a669a58ecb`: 2 info
  - added the new optional request property `aws/webIdentity`
  - added the optional property `data/aws/webIdentity` to the response with the `200` status
- **2026-01-24** `4455dbc25e7d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/golioth/apis/golioth-api/changes/v1/organizations/:organizationId/projects/:projectId/pki/providers/post.md)

---

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