/keywords/{id}

Use this resource to get detail, update or delete a keyword.

Secured By: Authentication Token
Description:

Get keyword detail.

Headers

Name Required Type Description
X-AUTH-TOKEN * string

An authentication token provided to you by GovDelivery.

Status

Body

Format: application/json

Example
{
  "name": "weather",
  "response_text": "Current Weather Conditions",
  "created_at": "2014-12-17T18:57:44Z",
  "updated_at": "2014-12-27T14:22:37Z",
  "_links": {
    "self": "/keywords/3",
    "commands": "/keywords/3/commands"
  }
}
Schema
Object that may include:
Name Type Description
name string

The name of the keyword. Case-insensitive.

Example

weather
response_text string

Optional response text that will be sent back to the SMS sender in an SMS

Example

Current Weather Conditions
created_at string

The date and time when the keyword was created.

Example

2013-01-30T17:45:27Z
updated_at string

The date and time when the keyword was last updated.

Example

2013-01-30T17:45:27Z
_links object

An object that defines links to related objects.

Properties

{
  "self": {
    "description": "Relative URI of the object",
    "type": "string",
    "example": "/keywords/3"
  },
  "commands": {
    "description": "Relative URI to the commands associated with this keyword",
    "type": "string",
    "example": "/keywords/3/commands"
  }
}
 
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "title": "Keyword",
  "type": "object",
  "properties": {
    "name": {
      "description": "The name of the keyword. Case-insensitive.",
      "type": "string",
      "example": "weather"
    },
    "response_text": {
      "description": "Optional response text that will be sent back to the SMS sender in an SMS",
      "type": "string",
      "example": "Current Weather Conditions"
    },
    "created_at": {
      "description": "The date and time when the keyword was created.",
      "type": "string",
      "example": "2013-01-30T17:45:27Z"
    },
    "updated_at": {
      "description": "The date and time when the keyword was last updated.",
      "type": "string",
      "example": "2013-01-30T17:45:27Z"
    },
    "_links": {
      "title": "Relational Links",
      "description": "An object that defines links to related objects.",
      "type": "object",
      "properties": {
        "self": {
          "description": "Relative URI of the object",
          "type": "string",
          "example": "/keywords/3"
        },
        "commands": {
          "description": "Relative URI to the commands associated with this keyword",
          "type": "string",
          "example": "/keywords/3/commands"
        }
      }
    }
  }
}

Body

Format: application/json

Example
{
  "error": "Invalid authentication token"
}
Secured By: Authentication Token
Description:

Update a keyword.

Headers

Name Required Type Description
X-AUTH-TOKEN * string

An authentication token provided to you by GovDelivery.

Body

Format: application/json

Example
{
  "name": "weather",
  "response_text": "Current Weather Conditions"
}
Schema
Object that may include:
Name Required Type Description
name * string

The name of the keyword. Case-insensitive.

Example

weather
response_text string

Optional response text that will be sent back to the SMS sender in an SMS

Example

Current Weather Conditions
 
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "title": "/keywords/{id}",
  "description": "Update a keyword.",
  "type": "object",
  "properties": {
    "name": {
      "description": "The name of the keyword. Case-insensitive.",
      "type": "string",
      "example": "weather"
    },
    "response_text": {
      "description": "Optional response text that will be sent back to the SMS sender\nin an SMS\n",
      "type": "string",
      "example": "Current Weather Conditions"
    }
  },
  "required": [
    "name"
  ]
}
Form Parameters
Name Required Type Description
name * string

The name of the keyword. Case-insensitive.

Example

weather
response_text string

Optional response text that will be sent back to the SMS sender in an SMS

Example

Current Weather Conditions

Status

Description

The updated keyword object

Body

Format: application/json

Example
{
  "name": "weather",
  "response_text": "Current Weather Conditions",
  "created_at": "2014-12-17T18:57:44Z",
  "updated_at": "2014-12-27T14:22:37Z",
  "_links": {
    "self": "/keywords/3",
    "commands": "/keywords/3/commands"
  }
}
Schema
Object that may include:
Name Type Description
name string

The name of the keyword. Case-insensitive.

Example

weather
response_text string

Optional response text that will be sent back to the SMS sender in an SMS

Example

Current Weather Conditions
created_at string

The date and time when the keyword was created.

Example

2013-01-30T17:45:27Z
updated_at string

The date and time when the keyword was last updated.

Example

2013-01-30T17:45:27Z
_links object

An object that defines links to related objects.

Properties

{
  "self": {
    "description": "Relative URI of the object",
    "type": "string",
    "example": "/keywords/3"
  },
  "commands": {
    "description": "Relative URI to the commands associated with this keyword",
    "type": "string",
    "example": "/keywords/3/commands"
  }
}
 
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "title": "Keyword",
  "type": "object",
  "properties": {
    "name": {
      "description": "The name of the keyword. Case-insensitive.",
      "type": "string",
      "example": "weather"
    },
    "response_text": {
      "description": "Optional response text that will be sent back to the SMS sender in an SMS",
      "type": "string",
      "example": "Current Weather Conditions"
    },
    "created_at": {
      "description": "The date and time when the keyword was created.",
      "type": "string",
      "example": "2013-01-30T17:45:27Z"
    },
    "updated_at": {
      "description": "The date and time when the keyword was last updated.",
      "type": "string",
      "example": "2013-01-30T17:45:27Z"
    },
    "_links": {
      "title": "Relational Links",
      "description": "An object that defines links to related objects.",
      "type": "object",
      "properties": {
        "self": {
          "description": "Relative URI of the object",
          "type": "string",
          "example": "/keywords/3"
        },
        "commands": {
          "description": "Relative URI to the commands associated with this keyword",
          "type": "string",
          "example": "/keywords/3/commands"
        }
      }
    }
  }
}

Body

Format: application/json

Example
{
  "error": "Invalid authentication token"
}
Secured By: Authentication Token
Description:

Delete a keyword.

Headers

Name Required Type Description
X-AUTH-TOKEN * string

An authentication token provided to you by GovDelivery.

Status

Body

Format: application/json

Example
{
  "error": "Invalid authentication token"
}