Retrieve a custom provider

GET

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

Retrieve a custom provider by its string provider ID. The current backend returns extra_kwargs, including any credentials stored in that object; handle this response as sensitive.

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.

Path parameters

provider_idstringRequired

Custom provider string ID returned as id and provider_id in provider responses.

Response

Provider details.

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

401

Unauthorized Error

404

Not Found Error

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	}