Made in 10Docs
GuidesAPI
ReferenceLinks

Make many personal links

Up to 500 links at once, all or none, in order.

POST
/links/batch

Authorization

secretKey
headerAuthorizationBearer <sk_live_… or sk_test_… (a prefix and 40 base62 characters)>

A secret key from the dashboard, sent as Authorization: Bearer sk_live_…. Live keys run real, charged calls; test keys (sk_test_…) run calls of at most 60 seconds, 20 a day per organization, never charged. Each key sees only its own env's calls, meetings, webhooks, memories and analytics. Publishable keys (pk_…) are refused.

Header Parameters

Idempotency-Key?string

Any string of 1 to 200 bytes (surrounding spaces are trimmed), unique per call you mean to start, such as a UUID. The same key gives back the same call. While the first request with it is still starting: 409 idempotency_in_progress; if it failed: 409 idempotency_failed (send a new key); used for another character: 422 idempotency_mismatch. Only the character is compared: a different max_seconds or metadata with the same key still gives back the first call. Keys are kept with the call, per organization and env: a test key and a live key sending the same value each get their own call (or meeting), never the other's. Use plain ASCII: a value that isn't is ignored, as if no key were sent.

Length1 <= length <= 200

Request Body

application/json
  1. body
links*array<>
Items1 <= items <= 500

Response Body

The links, in the order sent.

application/json
  1. response
data*array<>
Example Request
curl -X POST 'https://api.daxov.com/v1/links/batch' \  -H 'Idempotency-Key: 5f0c7a52-3d1e-4b8a-9f61-2c4d8e7b9a10' \  -H 'Content-Type: application/json' \  -d '{  "links": [    {      "character_id": "chr_4fT9kQ2mXw7LbN3pZs8V"    }  ]}'
Example Response
{  "data": [    {      "id": "lnk_8Hq2Lm5VtR9xPc3NwZ7k",      "url": "http://example.com",      "character_id": "chr_4fT9kQ2mXw7LbN3pZs8V",      "env": "live",      "status": "unused",      "name": "string",      "email": "string",      "external_id": "string",      "context": "string",      "variables": {        "property1": "string",        "property2": "string"      },      "language": "string",      "memory_key": "string",      "metadata": {},      "max_uses": 0,      "uses": 0,      "resume_minutes": 0,      "resume_until_unix": 0,      "expires_unix": 0,      "opened_unix": 0,      "consented_unix": 0,      "completed_unix": 0,      "revoked_unix": 0,      "created_unix": 0,      "last_call_id": "string",      "in_call": true,      "calls": [        {          "id": "call_2Gx7Mb9KpQ4sVn1ZrT6e",          "resumed": true,          "end_reason": "string",          "settled_unix": 0,          "created_unix": 0        }      ]    }  ]}