name_photo.share

POST /v1/commands/name_photo.share

Offers your iMessage name and photo to the other party in a direct message, the same prompt Messages shows when you share your contact card. Takes no arguments.

Routing path: agent-turn. Honours Idempotency-Key.

Target

Prop

Type

Unconfirmed

This is sometimes described as this command as accepting a recipient target as well, but the wire schema accepts a direct-message conversation only. Treat conversation targets as the supported form until this is settled.

Payload

Empty — but the key is still required:

{}

Request

curl $MAPIER_BASE_URL/v1/commands/name_photo.share \
  -H "Authorization: Bearer $MAPIER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "target": {
      "kind": "conversation",
      "conversationId": "a0000000-0000-4000-8000-000000000001"
    },
    "payload": {}
  }'

Response

202 Accepted

{ "commandId": "cmd-4", "status": "queued", "disposition": "queued" }

Outcomes are shared or not_offered. not_offered settles no_effect and means iMessage declined to show the prompt — usually because the card was already shared with that person.

Errors

Status	Code	Cause
`400`	`invalid_conversationId`	Not a UUID
`400`	`target_and_payload_required`	`payload` omitted entirely — send `{}`
`404`	`conversation_not_found`	Unknown conversation, or another account's
`503`	`no_live_connector`	No Mac available

Capabilities

Requires command.name_photo_share.v1.

Sharing your contact card

When the prompt appears and when it does not.