Preferred Authors

List preferred authors

By default, you can only list preferred authors which have been whitelisted or blacklisted. Preferred authors who completed a document of yours but you didn't rate can be found within the uncategorized list.

OAuth: This endpoint requires one of the following scopes: preferred_author:manage, preferred_author:read or preferred_author:write.

Get My Authors

get

Required scopes

This endpoint requires the following scopes:

• : Allow read & write access to My Authors
• : Allow read access to My Authors
• : Allow write access to My Authors

Authorizations

oauth2

OAuth2authorizationCodeRequired

OAuth2 Bearer token authentication

Authorization URL: Token URL: Refresh URL:

Query parameters

statusstring · enumOptional

The category of authors to list (lists all by default).

Prossible values:

• preferred
• blacklisted
• uncategorized
• my_textmaster (legacy, prefer 'preferred')

Possible values:

pageintegerOptional

Search results are limited to 100 items. Specify page number to read more than the first page.

per_pageintegerOptional

Number of items per page. Default is 100. Maximum is 100.

Responses

200

Lists My Authors

application/json

total_pagesintegerOptional

countintegerOptional

pageintegerOptional

per_pageintegerOptional

previous_pageinteger · nullableOptional

next_pageinteger · nullableOptional

401

Unauthorized

application/json

403

Forbidden

application/json

get/v1/clients/my_authors

HTTPcURLJavaScriptPython

GET /v1/clients/my_authors HTTP/1.1
Host: api.textmaster.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

{
  "total_pages": 1,
  "count": 1,
  "page": 1,
  "per_page": 100,
  "previous_page": null,
  "next_page": null,
  "my_authors": [
    {
      "id": "61698aaf8b81926d91c0e87a",
      "author_id": "61698aaf8b81926d91c0e86f",
      "author_name": "john",
      "author_ref": "A-986F-FM",
      "created_at": {
        "day": 15,
        "month": 10,
        "year": 2021,
        "full": "2021-10-15 14:05:35 UTC"
      },
      "description": "description",
      "latest_activity": "2021-10-15 14:05:06 UTC",
      "status": "preferred",
      "tags": [],
      "updated_at": {
        "day": 15,
        "month": 10,
        "year": 2021,
        "full": "2021-10-15 14:05:35 UTC"
      }
    }
  ]
}

Code samples

curl -G "https://api.textmaster.com/v1/clients/my_authors" \
  -H "Authorization: Bearer 790d0c6d24747b818f1c83184a2720e603db74b0b7de246365636765569c5d4e"

Add a preferred author

OAuth: This endpoint requires one of the following scopes: preferred_author:manage or referred_author:write.

Add a My Author

post

Required scopes

This endpoint requires the following scopes:

• : Allow read & write access to My Authors
• : Allow write access to My Authors

Authorizations

oauth2

OAuth2authorizationCodeRequired

OAuth2 Bearer token authentication

Authorization URL: Token URL: Refresh URL:

Body

application/json

Responses

200

My Author Created

application/json

idstringOptional

author_idstringOptional

author_namestringOptional

author_refstringOptional

descriptionstring · nullableOptional

latest_activitystringOptional

statusstringOptional

tagsstring[]Optional

401

Unauthorized

application/json

403

Forbidden

application/json

422

Unprocessable Entity

application/json

post/v1/clients/my_authors

HTTPcURLJavaScriptPython

POST /v1/clients/my_authors HTTP/1.1
Host: api.textmaster.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 110

{
  "my_author": {
    "author_id": "61698ab08b81926d91c0e8a3",
    "description": "Some personal note",
    "status": "preferred"
  }
}

{
  "id": "61698ab08b81926d91c0e8ae",
  "author_id": "61698ab08b81926d91c0e8a3",
  "author_name": "john",
  "author_ref": "A-98A3-FM",
  "created_at": {
    "day": 15,
    "month": 10,
    "year": 2021,
    "full": "2021-10-15 14:05:36 UTC"
  },
  "description": "Some personal note",
  "latest_activity": "2021-10-15 14:05:06 UTC",
  "status": "preferred",
  "tags": [],
  "updated_at": {
    "day": 15,
    "month": 10,
    "year": 2021,
    "full": "2021-10-15 14:05:36 UTC"
  }
}

Code samples

curl "https://api.textmaster.com/v1/clients/my_authors" \
  -X POST \
  -d '{
    "my_author": {
      "description": "Some description",
      "status": "my_textmaster",
      "author_id": "61698aaf8b81926d91c0e889"
    }
  }' \
  -H "Authorization: Bearer 3a7dce3b773247c159b8f18be707c2c5838d2e7138d36813e74e28e43caa0aaa" \
  -H "Content-Type: application/json"

Get a preferred author

OAuth: This endpoint requires one of the following scopes: preferred_author:manage, preferred_author:read or referred_author:write.

Retrieve a single My Author

get

Required scopes

This endpoint requires the following scopes:

• : Allow read & write access to My Authors
• : Allow read access to My Authors
• : Allow write access to My Authors

Authorizations

oauth2

OAuth2authorizationCodeRequired

OAuth2 Bearer token authentication

Authorization URL: Token URL: Refresh URL:

Path parameters

author_idstringRequired

(required) ID of the Author

Responses

200

Gets My Author Info

application/json

idstringOptional

author_idstringOptional

author_namestringOptional

author_refstringOptional

descriptionstring · nullableOptional

latest_activitystringOptional

statusstringOptional

tagsstring[]Optional

401

Unauthorized

application/json

403

Forbidden

application/json

404

My Author Info Not Found

application/json

get/v1/clients/my_authors/{author_id}

HTTPcURLJavaScriptPython

GET /v1/clients/my_authors/{author_id} HTTP/1.1
Host: api.textmaster.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

{
  "id": "61698ab08b81926d91c0e8ae",
  "author_id": "61698ab08b81926d91c0e8a3",
  "author_name": "john",
  "author_ref": "A-98A3-FM",
  "created_at": {
    "day": 15,
    "month": 10,
    "year": 2021,
    "full": "2021-10-15 14:05:36 UTC"
  },
  "description": "description",
  "latest_activity": "2021-10-15 14:05:06 UTC",
  "status": "preferred",
  "tags": [],
  "updated_at": {
    "day": 15,
    "month": 10,
    "year": 2021,
    "full": "2021-10-15 14:05:36 UTC"
  }
}

Code samples

curl -G "https://api.textmaster.com/v1/clients/my_authors/61698ab08b81926d91c0e8a3" \
  -H "Authorization: Bearer f2a5e17102ca9e6c8494b323847b784615ab1da0f1525258d85af89385fef5f5"

Update a preferred author

OAuth: This endpoint requires one of the following scopes: preferred_author:manage or referred_author:write.

Update My Author

put

Required scopes

This endpoint requires the following scopes:

• : Allow read & write access to My Authors
• : Allow write access to My Authors

Authorizations

oauth2

OAuth2authorizationCodeRequired

OAuth2 Bearer token authentication

Authorization URL: Token URL: Refresh URL:

Path parameters

author_idstringRequired

(required) ID of the Author

Body

application/json

Responses

200

My Author Updated

application/json

idstringOptional

author_idstringOptional

author_namestringOptional

author_refstringOptional

descriptionstring · nullableOptional

latest_activitystringOptional

statusstringOptional

tagsstring[]Optional

401

Unauthorized

application/json

403

Forbidden

application/json

404

My Author Info Not Found

application/json

422

Unprocessable Entity

application/json

put/v1/clients/my_authors/{author_id}

HTTPcURLJavaScriptPython

PUT /v1/clients/my_authors/{author_id} HTTP/1.1
Host: api.textmaster.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 74

{
  "my_author": {
    "description": "Updated personal note",
    "status": "preferred"
  }
}

{
  "id": "61698ab08b81926d91c0e8ae",
  "author_id": "61698ab08b81926d91c0e8a3",
  "author_name": "john",
  "author_ref": "A-98A3-FM",
  "created_at": {
    "day": 15,
    "month": 10,
    "year": 2021,
    "full": "2021-10-15 14:05:36 UTC"
  },
  "description": "description",
  "latest_activity": "2021-10-15 14:05:06 UTC",
  "status": "my_textmaster",
  "tags": [],
  "updated_at": {
    "day": 15,
    "month": 10,
    "year": 2021,
    "full": "2021-10-15 14:05:36 UTC"
  }
}

Code samples

curl "https://api.textmaster.com/v1/clients/my_authors/61698ab08b81926d91c0e8bd" \
  -X PUT \
  -d '{ "my_author": { "description": "Some new description" } }' \
  -H "Authorization: Bearer b9ad70843ca9d09f59bc27f87c1aab02de0dfd03109ca1a7a3f70f899f6427c6" \
  -H "Content-Type: application/json"

List preferred authors able to work on project

OAuth: This endpoint requires one of the following scopes: preferred_author:manage, preferred_author:read or referred_author:write.

Get all My Authors who can do a given Project

get

Required scopes

This endpoint requires the following scopes:

• : Allow read & write access to My Authors
• : Allow read access to My Authors
• : Allow write access to My Authors

Authorizations

oauth2

OAuth2authorizationCodeRequired

OAuth2 Bearer token authentication

Authorization URL: Token URL: Refresh URL:

Path parameters

project_idstringRequired

The Project ID.

Query parameters

statusstring · enumOptional

The category of authors to list (lists all by default).

Prossible values:

• preferred
• blacklisted
• uncategorized
• my_textmaster (legacy, prefer 'preferred')

Possible values:

pageintegerOptional

Search results are limited to 100 items. Specify page number to read more than the first page.

Responses

200

Lists possible My Authors

application/json

total_pagesintegerOptional

countintegerOptional

pageintegerOptional

per_pageintegerOptional

previous_pageinteger · nullableOptional

next_pageinteger · nullableOptional

401

Unauthorized

application/json

403

Forbidden

application/json

get/v1/clients/projects/{project_id}/my_authors

HTTPcURLJavaScriptPython

GET /v1/clients/projects/{project_id}/my_authors HTTP/1.1
Host: api.textmaster.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

{
  "total_pages": 1,
  "count": 1,
  "page": 1,
  "per_page": 20,
  "previous_page": null,
  "next_page": null,
  "my_authors": [
    {
      "id": "61698aaf8b81926d91c0e87a",
      "author_id": "61698aaf8b81926d91c0e86f",
      "author_name": "john",
      "author_ref": "A-986F-FM",
      "created_at": {
        "day": 15,
        "month": 10,
        "year": 2021,
        "full": "2021-10-15 14:05:35 UTC"
      },
      "description": "description",
      "latest_activity": "2021-10-15 14:05:06 UTC",
      "status": "preferred",
      "tags": [],
      "updated_at": {
        "day": 15,
        "month": 10,
        "year": 2021,
        "full": "2021-10-15 14:05:35 UTC"
      }
    }
  ]
}

Code samples

curl -G "https://api.textmaster.com/v1/clients/projects/61698ab18b81926d91c0e8e7/my_authors" \
  -H "Authorization: Bearer 2a1e347c6aaf1515cbb7e146601e93832359d4edc437e0d494ed195facccc05d"