Create a custom provider

POST

https://api.respan.ai/api/providers/

Create a custom provider. Use PATCH /api/providers/{provider_id}/ to update an existing provider.

Authentication

AuthorizationBearer

Use your Respan API key for Respan API authentication. Enter only the Respan API key value; clients send Authorization: Bearer <RESPAN_API_KEY>. For /api/responses, provider credentials such as Perplexity, OpenAI, or Azure OpenAI go in Settings -> Providers or respan_params.credential_override in the request body, not in this authentication field.

AuthorizationBearer

Use a dashboard JWT only for dashboard-authenticated endpoints. Respan API-key endpoints use the respanApiKey auth field instead.

Request

This endpoint expects an object.

provider_idstringRequired

Unique provider identifier within your organization.

provider_namestringRequired

Human-readable provider name.

extra_kwargsmap from strings to anyOptional

Provider configuration. Put provider credentials under extra_kwargs.api_key.

Response

Created provider.

idstring

Provider string ID. Same value as provider_id.

provider_idstring

Unique provider identifier within your organization.

provider_namestring

Human-readable provider name.

extra_kwargsmap from strings to anyOptional

Stored provider configuration. The current backend returns this object, including credentials it contains; handle the response as sensitive.

created_atdatetime or nullOptional

updated_atdatetime or nullOptional

Errors

400

Bad Request Error

401

Unauthorized Error

$	curl -X POST https://api.respan.ai/api/providers/ \
>	-H "Authorization: Bearer <respanApiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"provider_id": "my-vllm",
>	"provider_name": "My vLLM Server"
>	}'

1	{
2	"id": "my-vllm",
3	"provider_id": "my-vllm",
4	"provider_name": "My vLLM Server",
5	"extra_kwargs": {
6	"base_url": "https://vllm.example.com/v1"
7	},
8	"created_at": "2024-01-15T09:30:00Z",
9	"updated_at": "2024-01-15T09:30:00Z"
10	}