Reserve a new integration | Runtype Documentation

Reserve a new integration row server-side. Returns a pending row scoped to the authenticated owner whose id may be embedded in provider manifests before credentials are supplied.

Authentication

AuthorizationBearer

API key or Clerk session token

Request

This endpoint expects an object.

providerenumRequired

Allowed values:

Response

Pending integration reserved

createdAtstring

expiresAtstring

idstring

providerstring

statusstring

Errors

401

Unauthorized Error

403

Forbidden Error

500

Internal Server Error

$	curl -X POST https://api.runtype.com/v1/integrations \
>	-H "Authorization: <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"provider": "slack"
>	}'

1	{
2	"createdAt": "2024-06-01T10:15:30Z",
3	"expiresAt": "2024-06-08T10:15:30Z",
4	"id": "a1b2c3d4-e5f6-7890-ab12-cd34ef567890",
5	"provider": "slack",
6	"status": "pending"
7	}

$	curl -X POST https://api.runtype.com/v1/integrations \
>	-H "Authorization: <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"provider": "slack"
>	}'

1	{
2	"createdAt": "2024-06-01T10:15:30Z",
3	"expiresAt": "2024-06-08T10:15:30Z",
4	"id": "a1b2c3d4-e5f6-7890-ab12-cd34ef567890",
5	"provider": "slack",
6	"status": "pending"
7	}