Kantata Kantata OX Knowledge Base
Release Notes
Status Page

Followers

Story Follows allow users to follow a task to which they are not assigned.

Fetching a list of Story Follows

By default, you will get all story follows that you are permitted to see. If you are an Administrator, you will see every story follow on your account. Otherwise you will see every story follow in projects in which you are participating.

Responses
400

Bad Request

401

Unauthorized request

403

Forbidden request

404

Page Not Found

422

Unprocessable Entity

503

Service is unavailable

get/story_follows
Request samples
Response samples
application/json
{
  • "errors": [
    ]
}

Following a story

Request
Request Body schema: application/json
required
object
story_id
required
integer <int32>

The ID of the associated task (story).

follower_id
required
integer <int32>

The ID of the user to add as a follower.

Responses
400

Bad Request

401

Unauthorized request

403

Forbidden request

404

Page Not Found

422

Unprocessable Entity

503

Service is unavailable

post/story_follows
Request samples
application/json
{
  • "story_follow": {
    }
}
Response samples
application/json
{
  • "errors": [
    ]
}

Retrieving a single Story Follow

Request
path Parameters
id
required
integer

The ID of the Model.

Responses
400

Bad Request

401

Unauthorized request

403

Forbidden request

404

Page Not Found

422

Unprocessable Entity

503

Service is unavailable

get/story_follows/{id}
Request samples
Response samples
application/json
{
  • "errors": [
    ]
}

Unfollowing a story

The response will contain no content and an HTTP 204 status code if the request was successful, or a standard Kantata OX error message explaining why the object could not be deleted.

Request
path Parameters
id
required
integer

The ID of the Model.

Responses
204

object has been deleted.

400

Bad Request

401

Unauthorized request

403

Forbidden request

404

Page Not Found

422

Unprocessable Entity

503

Service is unavailable

delete/story_follows/{id}
Request samples
Response samples
application/json
{
  • "errors": [
    ]
}