Tags

Get tags

get

/api/v3/tags

Authorizations

Query parameters

orderbystring

Sorting parameter Available values : entity fields Default value : id

orderstring

Sorting parameter Available values : [ASC,DESC] !! Default value : ASC "default not working"

limitinteger int32

Paging parameter Default value : null

offsetinteger int32

Paging parameter Default value : 0

tagstring

Filter parameter return categories have a tag field exactly same as the value

typestring

Filter parameter return categories have a this type

qstring

levelstring

Filter parameter return only parent categories if it has (parent) value

parent_idinteger int32

filter paramter return the sub categories of parent

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://ushahididocs.api.ushahidi.io/api/v3/tags' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

200

200

{
  "count": 2,
  "results": [
    {
      "id": 10,
      "url": "https://ushahididocs.api.ushahidi.io//api/v3/tags/10",
      "parent": {
        "id": 9,
        "url": "https://ushahididocs.api.ushahidi.io//api/v3/tags/9"
      },
      "tag": "Child 1",
      "slug": "child-one",
      "type": "category",
      "icon": "tag",
      "priority": 0,
      "created": "1970-01-01T00:00:00.000Z",
      "role": [
        "admin"
      ],
      "children": [],
      "allowed_privileges": [
        "read",
        "create",
        "update",
        "delete",
        "search"
      ]
    },
    {
      "id": 11,
      "url": "https://ushahididocs.api.ushahidi.io//api/v3/tags/11",
      "parent": {
        "id": 9,
        "url": "https://ushahididocs.api.ushahidi.io//api/v3/tags/9"
      },
      "tag": "Child 2",
      "slug": "child-two",
      "type": "category",
      "icon": "tag",
      "priority": 0,
      "created": "1970-01-01T00:00:00.000Z",
      "role": [
        "admin"
      ],
      "children": [],
      "allowed_privileges": [
        "read",
        "create",
        "update",
        "delete",
        "search"
      ]
    }
  ],
  "offset": 0,
  "order": "asc",
  "orderby": "id",
  "curr": "https://ushahididocs.api.ushahidi.io//api/v3/tags?orderby=id&order=asc&offset=0",
  "next": "https://ushahididocs.api.ushahidi.io//api/v3/tags?orderby=id&order=asc&offset=0",
  "prev": "https://ushahididocs.api.ushahidi.io//api/v3/tags?orderby=id&order=asc&offset=0",
  "total_count": 2
}

OK

Add tag

POST ushahididocs.api.ushahidi.io/api/v3/tags

Request Body

Name	Type	Description
parent_id	integer	Parent identifier for Tag
icon	String	Tag icon name
description	String	Tag description
color	String	Tag color
type	String	Type of tag
tag	String	Tag name
role	Array	Tag role
priority	Integer	Tag priority value
children	Array	An array of other dependent children tag

200: OK

{
  "id": 0,
  "url": "string",
  "parent_id": "string",
  "tag": "string",
  "slug": "string",
  "type": "string",
  "color": "string",
  "icon": "string",
  "description": "string",
  "priority": 0,
  "created": "string",
  "role": [
    "string"
  ],
  "children": [
    "string"
  ],
  "allowed_privileges": [
    "string"
  ]
}

Edit tag

PUT ushahididocs.api.ushahidi.io/api/v3/tags/2

Request Body

Name	Type	Description
parent_id	Integer	Parent identifier for Tag
icon	String	Tag icon name
description	String	Tag description
color	String	Tag color
type	String	Type of tag
tag	String	Tag name
role	Array	Tag role
priority	Integer	Tag priority value
children	Array	An array of other dependent children tag

200: OK

{
  "id": 0,
  "url": "string",
  "parent_id": "string",
  "tag": "string",
  "slug": "string",
  "type": "string",
  "color": "string",
  "icon": "string",
  "description": "string",
  "priority": 0,
  "created": "string",
  "role": [
    "string"
  ],
  "children": [
    "string"
  ],
  "allowed_privileges": [
    "string"
  ]
}

Get tag

get

/api/v3/tags/5

Authorizations

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://ushahididocs.api.ushahidi.io/api/v3/tags/5' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

200

404

200

{
  "id": 1,
  "url": "https://ushahididocs.api.ushahidi.io//api/v3/tags/1",
  "tag": "Test tag",
  "slug": "test-tag",
  "type": "category",
  "icon": "tag",
  "priority": 0,
  "created": "1970-01-01T00:00:00.000Z",
  "role": [
    "admin",
    "user"
  ],
  "children": [],
  "allowed_privileges": [
    "read",
    "create",
    "update",
    "delete",
    "search"
  ]
}

OK

Delete tag

delete

/api/v3/tags/5

Authorizations

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request DELETE \
  --url 'https://ushahididocs.api.ushahidi.io/api/v3/tags/5' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

200

404

200

{
  "id": 5,
  "url": "https://ushahididocs.api.ushahidi.io//api/v3/tags/5",
  "tag": "Todo",
  "slug": "todo",
  "type": "status",
  "icon": "tag",
  "priority": 0,
  "created": "1970-01-01T00:00:00.000Z",
  "children": [
    {
      "id": 7,
      "url": "https://ushahididocs.api.ushahidi.io//api/v3/tags/7"
    },
    {
      "id": 23,
      "url": "https://ushahididocs.api.ushahidi.io//api/v3/tags/23"
    }
  ],
  "allowed_privileges": [
    "read",
    "create",
    "update",
    "delete",
    "search"
  ]
}

OK