List all published projects (flat)

GET

/projects/list

const url = 'https://agent-dev.azizdubai.com/projects/list';
const options = {method: 'GET', headers: {'X-API-Key': '<X-API-Key>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://agent-dev.azizdubai.com/projects/list \
  --header 'X-API-Key: <X-API-Key>'

Returns id, name and the first image of each project, for the “Project” filter dropdown. Not paginated or filterable; sorted by name.

Authorizations

apiKeyHeader
bearerKey

Responses

200

All published projects.

application/json

object

status

required

string

Allowed value: success

data

required

The shape depends on the operation.

data

required

object

items

Array<object>

object

integer

name

string

logo

Ready-to-use link to the project’s first image.

string | null

Example

{
  "status": "success"
}

401

The key is missing (missing api key) or invalid (invalid api key). The latter covers unknown, revoked and deleted keys. Every operation requires a key, so any request without one receives this response.

application/json

object

status

required

string

Allowed value: error

message

required

Human-readable message.

string

Examples

invalid

{
  "status": "error",
  "message": "invalid api key"
}

403

The key is valid, but it is restricted to a list of domains and the request’s Origin (or Referer) does not match any of them; or the key’s agency has no approved licence.

application/json

object

status

required

string

Allowed value: error

message

required

Human-readable message.

string

Examples

{
  "status": "error",
  "message": "origin is not allowed for this api key"
}

{
  "status": "error",
  "message": "agency license is required: upload a company license and wait for its approval"
}

500

An unexpected error. The cause is logged; a generic message is returned.

application/json

object

status

required

string

Allowed value: error

message

required

Human-readable message.

string

Examples

generic

{
  "status": "error",
  "message": "internal server error"
}