Mailboxes

Upload Persona Photo

Set the photo this sender persona uses. Multipart upload.

REPLACES the current photo. The image is stored by graph8 and referenced from the returned photo_url; 503 means photo storage was unavailable and the persona is unchanged, so it is safe to retry.

Org admins and owners only, and a personal API key.

post/mailboxes/personas/{persona_id}/photo

Request

  • Base URL: https://be.graph8.com/api/v1
  • URL: https://be.graph8.com/api/v1/mailboxes/personas/{persona_id}/photo
  • Auth: HTTP bearer

Path parameters

persona_idinteger required

Sender persona id - from GET /mailboxes/personas

Headers

Authorizationstring nullable
X-Target-Org-Idstring nullable

Response

Successful Response

dataMailboxDomainPayload required

An open envelope for one provider/deliverability result.

Open on purpose. These payloads are provider state and advisory reads whose contents grow with the product, and a dropped field reads as "nothing to report" rather than "we did not tell you". Every value passes through scrub_vendor_names on the way in.

Changes

No recorded changes to this operation across all 2 revisions of this API.