Setup
Features
API

Tags

Manage your tags via the API

Get a list of Tags

GET /tags

curl -X GET https://app.1pilot.io/api/v1/tags \
    -H "Accept: application/json" \
    -H "Authorization: Bearer $TOKEN"
Headers
Authorization Authentication Token
value: Bearer $TOKEN
Accept application/json

Responses

HTTP 200 Tags list. 

{ 
    "data": [ 
        { 
            "id": 1, 
            "name": "Test", 
            "created_at": "2018-01-31T10:27:39+00:00", 
            "updated_at": "2018-01-31T10:27:39+00:00" 
        }, 
        { 
            "id": 5, 
            "name": "My tag", 
            "created_at": "2018-02-01T13:46:53+00:00", 
            "updated_at": "2018-02-14T15:10:59+00:00" 
        } 
    ], 
    "links": { 
        "first": "https://app.1pilot.io/api/v1/tags?page=1", 
        "last": "https://app.1pilot.io/api/v1/tags?page=1", 
        "prev": null, 
        "next": null 
    }, 
    "meta": { 
        "current_page": 1, 
        "from": 1, 
        "last_page": 1, 
        "path": "https://app.1pilot.io/api/v1/tags", 
        "per_page": 15, 
        "to": 2, 
        "total": 2 
    }
}

Create new tag

POST /tags

curl -X POST https://app.1pilot.io/api/v1/tags \
    -H "Accept: application/json" \
    -H "Authorization: Bearer $TOKEN" \
    -H "Content-Type: application/json" \
    --data '{
        "name": "My new Tag"
    }'
Headers
Authorization Bearer $TOKEN
Accept application/json
Parameters Type
name string The name of the tag to create

Responses

HTTP 200 Your new tag. 

{
    "data": {
        "id": 7,
        "name": "My new Tag",
        "created_at": "2018-06-15T09:37:23+00:00",
        "updated_at": "2018-06-15T09:37:23+00:00"
    }
}

Delete a tag

POST /tags/:id

curl -X DELETE https://app.1pilot.io/api/v1/tags/$ID \
    -H "Accept: application/json" \
    -H "Authorization: Bearer $TOKEN"
Headers
Authorization Bearer $TOKEN
Accept application/json

Responses

HTTP 200 empty response.
On this page