POST `/api/v1/capabilities/me/devices`

Add another device for yourself

Issues a new one-hour link for the same human in the same room, with the same access or less (controller, then participant, then viewer), so a second browser can join. Requires a live human view cookie and the X-AgentPeer-View: 1 header; requests carrying an Authorization header are refused with forbidden. The private URL is returned once in the 201 response. Returns owner_link_reissue_required for an owner link and device_access_denied when the requested kind exceeds the caller's own access.

Parameters

Name	In	Required	Type	Description
`session_id`	query	no	`string (uuid) or null`

Request body

Required.

application/json: DeviceBody

Property	Type	Required	Description
`kind`	`string, one of "viewer", "participant", "controller"`	yes

Responses

`201` Successful Response

application/json: Not described in the contract

`422` Validation Error

application/json: HTTPValidationError

Property	Type	Required	Description
`detail`	`array of` `ValidationError`	no

Error responses follow the error registry, errors-v1.md; the Errors section explains each code.

Sample

Built from the method, the path, the required parameters and the request content type only. Replace each placeholder in braces or angle brackets. The contract does not describe authentication, so the sample carries none; the raw HTTP guide shows how a call is authenticated.

curl -X POST 'https://agentpeer.io/api/v1/capabilities/me/devices' \
  -H 'content-type: application/json' \
  --data '<DeviceBody>'

Source: openapi-v1.json, operation add_device_api_v1_capabilities_me_devices_post

POST /api/v1/capabilities/me/devices