Lists

The segments endpoint provides access to lists where you can organize and manage contacts.

Creates a Segment resource.

post

Creates a Segment resource.

Authorizations

Body

idstring | nullOptional

titlestring | nullRequired

iconstring | nullRequired

sequenceinteger | nullOptional

Responses

201

Segment resource created

400

Invalid input

403

Forbidden

422

An error occurred

post

/segments

POST /segments HTTP/1.1
Host: api.rogerroger.io
Content-Type: application/ld+json
Accept: */*
Content-Length: 52

{
  "id": null,
  "title": null,
  "icon": null,
  "sequence": null
}

{
  "@context": "text",
  "@id": "text",
  "@type": "text",
  "id": null,
  "title": null,
  "icon": null,
  "sequence": null
}

Retrieves a Segment resource.

get

Retrieves a Segment resource.

Authorizations

Path parameters

idstringRequired

Segment identifier

Responses

200

Segment resource

403

Forbidden

404

Not found

get

/segments/{id}

GET /segments/{id} HTTP/1.1
Host: api.rogerroger.io
Accept: */*

{
  "@context": "text",
  "@id": "text",
  "@type": "text",
  "id": null,
  "title": null,
  "icon": null,
  "sequence": null
}

Updates the Segment resource.

patch

Updates the Segment resource.

Authorizations

Path parameters

idstringRequired

Segment identifier

Body

idstring | nullOptional

titlestring | nullOptional

iconstring | nullOptional

sequenceinteger | nullOptional

Responses

200

Segment resource updated

400

Invalid input

403

Forbidden

404

Not found

422

An error occurred

patch

/segments/{id}

PATCH /segments/{id} HTTP/1.1
Host: api.rogerroger.io
Content-Type: application/merge-patch+json
Accept: */*
Content-Length: 52

{
  "id": null,
  "title": null,
  "icon": null,
  "sequence": null
}

{
  "@context": "text",
  "@id": "text",
  "@type": "text",
  "id": null,
  "title": null,
  "icon": null,
  "sequence": null
}

Replaces the Segment resource.

put

Replaces the Segment resource.

Authorizations

Path parameters

idstringRequired

Segment identifier

Body

idstring | nullOptional

titlestring | nullRequired

iconstring | nullRequired

sequenceinteger | nullOptional

Responses

200

Segment resource updated

400

Invalid input

403

Forbidden

404

Not found

422

An error occurred

put

/segments/{id}

PUT /segments/{id} HTTP/1.1
Host: api.rogerroger.io
Content-Type: application/ld+json
Accept: */*
Content-Length: 52

{
  "id": null,
  "title": null,
  "icon": null,
  "sequence": null
}

{
  "@context": "text",
  "@id": "text",
  "@type": "text",
  "id": null,
  "title": null,
  "icon": null,
  "sequence": null
}

Retrieves the collection of Segment resources.

get

Retrieves the collection of Segment resources.

Authorizations

Query parameters

pageintegerOptional

The collection page number

Default: 1

itemsPerPageinteger · max: 30Optional

The number of items per page

Default: 15

Responses

200

Segment collection

403

Forbidden

get

/segments

GET /segments HTTP/1.1
Host: api.rogerroger.io
Accept: */*

{
  "member": [
    {
      "@context": "text",
      "@id": "text",
      "@type": "text",
      "id": null,
      "title": null,
      "icon": null,
      "sequence": null
    }
  ],
  "totalItems": 1,
  "view": {
    "@id": "string",
    "type": "string",
    "first": "string",
    "last": "string",
    "previous": "string",
    "next": "string"
  },
  "search": {
    "@type": "text",
    "template": "text",
    "variableRepresentation": "text",
    "mapping": [
      {
        "@type": "text",
        "variable": "text",
        "property": null,
        "required": true
      }
    ]
  }
}

PreviousOrganizations NextWorkspaces

Last updated 7 months ago

hashtagCreates a Segment resource.

hashtagRetrieves a Segment resource.

hashtagUpdates the Segment resource.

hashtagReplaces the Segment resource.

hashtagRetrieves the collection of Segment resources.

Creates a Segment resource.

Retrieves a Segment resource.

Updates the Segment resource.

Replaces the Segment resource.

Retrieves the collection of Segment resources.