spaces

Request to add a contact to the space address book

Changed on

Creates a request to add a contact to the shared space address book. The proposed contact (name, address, chain ids) is stored on the request and added to the address book once an admin approves it.

post/v1/spaces/{spaceId}/address-book/requests

Request

  • The document declares no server URL.
  • Auth: none declared

Path parameters

spaceIdstring required
Example:123e4567-e89b-12d3-a456-426614174000

Space UUID

Request body

namestring required

Name of the proposed contact

addressstring required

Address of the contact to propose for the space address book

chainIdsstring[] required

Chain ids the contact applies to (at least one, duplicates are removed)

Response

Request created successfully

idnumber required
namestring required
addressstring required
chainIdsstring[] required
requestedBystring required

Email or wallet address of the requester, "Unknown user" if the user has no display identity, or "Deleted user"

requestedByUserIdnumber required

User ID of the requester

reviewedBystring nullable required

Email or wallet address of the reviewing admin, "Unknown user", "Deleted user", or null when still PENDING

reviewedByUserIdnumber nullable required

User ID of the reviewing admin, null when still PENDING

status'PENDING' | 'APPROVED' | 'REJECTED' required
createdAtstring date-time required
updatedAtstring date-time required

Changes

  • 4f3578bf7b4eRevision changes
    • breaking

      added the new required request property

    • breaking

      added the new required request property

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      removed the non-success response with the status

  • 081e1944f67cRevision changes
    • info

      for the path request parameter spaceId, the type was generalized from number to string