Artists

Search Artists

GET https://e621.net/artists.json

Query Parameters

Name	Type	Description
search[name]	String	The name of the artist.
search[group_name]	String	The group name of the artist.
search[any_other_name_like]	String	Any name being similar.
search[any_name_matches]	String	Any name matching.
search[any_name_or_url_matches]	String	Any name or url matching.
search[url_matches]	String	Any url matching.
search[is_active]	Boolean	If the artist is active.
search[creator_name]	String	The name of the creator of the artist.
search[creator_id]	Number	The ID of the creator of the artist.
search[has_tag]	Boolean	If the artist has a tag.
search[is_linked]	Boolean	If the artist is linked to a user.
search[order]	String	The order of the returned results. One of: updated_at, name, post_count
search[id]	Number	See Search Parameters: search[id]
limit	Number	See Search Parameters: limit
page	String	See Search Parameters: page

200: OK Success (Results)

[
  {
    "created_at": "0000-00-00T00:00:00.000-00:00",
    "creator_id": 0, // user id
    "group_name": "",
    "id": 0,
    "is_active": true,
    "is_locked": false,
    "linked_user_id": null, // user id
    "name": "",
    "notes": null,
    "other_names": [
      "othername"
    ],
    "updated_at": "0000-00-00T00:00:00.000-00:00",
    "urls": [
      {
        "artist_id": 0,
        "created_at": "0000-00-00T00:00:00.000-00:00",
        "id": 0,
        "is_active": true,
        "updated_at": "0000-00-00T00:00:00.000-00:00",
        "url": "https://e621.net",
        "normalized_url": "http://e621.net/"
      }
    ]
  }
]

200: OK Success (No Results)

[]

Get An Artist

GET https://e621.net/artists/{nameOrID}.json

Path Parameters

Name	Type	Description
nameOrID*	String	The name or ID of the artist to get.

200: OK Success

{
  "created_at": "0000-00-00T00:00:00.000-00:00",
  "creator_id": 0, // user id
  "group_name": "",
  "id": 0,
  "is_active": true,
  "is_locked": false,
  "linked_user_id": null, // user id
  "name": "",
  "notes": null,
  "other_names": [
    "othername"
  ],
  "updated_at": "0000-00-00T00:00:00.000-00:00",
  "domains": [
    [
      "e621.net",
      1
    ]
  ],
  "urls": [
    {
      "artist_id": 0,
      "created_at": "0000-00-00T00:00:00.000-00:00",
      "id": 0,
      "is_active": true,
      "updated_at": "0000-00-00T00:00:00.000-00:00",
      "url": "https://e621.net",
      "normalized_url": "http://e621.net/"
    }
  ]
}

404: Not Found Not Found

{
  "success": false,
  "reason": "not found"
}

Create An Artist

POST https://e621.net/artists.json

Authorization Required

Privileged+ Required If account is less than one week old.

other_names & urls are silently truncated to 25 entries.

notes is silently truncated to the wiki page limit (250,000).

Individual other_names are silently truncated to 100 characters.

Request Body

Name	Type	Description
artist[name]*	String	The name of the artist.
artist[group_name]	String	The group name of the artist.
artist[is_active]	Boolean	If the artist is active. Janitor+ Required
artist[is_locked]	Boolean	If the artist is locked. Janitor+ Required
artist[linked_user_id]	Number	The id of the user to link with the artist. A single user can be linked to multiple artists. Janitor+ Required
artist[notes]	String	The notes for the artist.
artist[other_names_string]	String	The other names of the artist.
artist[url_string]	String	The urls of the artist.

201: Created Success

{
  "created_at": "0000-00-00T00:00:00.000-00:00",
  "creator_id": 0, // user id
  "group_name": "",
  "id": 0,
  "is_active": true,
  "is_locked": false,
  "linked_user_id": null, // user id
  "name": "",
  "notes": null,
  "other_names": [
    "othername"
  ],
  "updated_at": "0000-00-00T00:00:00.000-00:00"
}

403: Forbidden Access Denied

{
  "success": false,
  "reason": "Access Denied"
}

422: Unprocessable Entity Duplicate Name

{
  "errors": {
    "name": [
      "has already been taken"
    ]
  }
}

422: Unprocessable Entity Account Too New

{
  "errors": {
    "base": [
      "User can not yet perform this action. Account is too new."
    ]
  }
}

422: Unprocessable Entity Empty Name

{
  "errors": {
    "name": [
      "'' cannot be blank"
    ]
  }
}

422: Unprocessable Entity Name Too Long

{
  "errors": {
    "name": [
      "is too long (maximum is 100 characters)"
    ]
  }
}

422: Unprocessable Entity Group Name Too Long

{
  "errors": {
    "group_name": [
      "is too long (maximum is 100 characters)"
    ]
  }
}

422: Unprocessable Entity URL Too Long

{
  "errors": {
    "urls.url": [
      "is too long (maximum is 4096 characters)"
    ]
  }
}

Edit An Artist

PATCH https://e621.net/artists/{id}.json

Authorization Required

Privileged+ Required If account is less than one week old.

Janitor+ Required If artist is locked or inactive.

other_names & urls are silently truncated to 25 entries.

notes is silently truncated to the wiki page limit (250,000).

Individual other_names are silently truncated to 100 characters.

Path Parameters

Name	Type	Description
id*	Number	The ID of the artist to edit.

Request Body

Name	Type	Description
artist[group_name]	String	The group name of the artist.
artist[is_active]	Boolean	If the artist is active. Janitor+ Required
artist[is_locked]	Boolean	If the artist is locked. Janitor+ Required
artist[linked_user_id]	Number	The id of the user to link with the artist. A single user can be linked to multiple artists. Janitor+ Required
artist[name]	String	The name of the artist.
artist[notes]	String	The notes for the artist.
artist[other_names_string]	String	The other names of the artist.
artist[url_string]	String	The urls of the artist.

204: No Content Success

403: Forbidden Access Denied

{
  "success": false,
  "reason": "Access Denied"
}

404: Not Found Not Found

{
  "success": false,
  "reason": "not found"
}

422: Unprocessable Entity Inactive Artist

{
  "errors": {
    "base": [
      "Artist is inactive"
    ]
  }
}

422: Unprocessable Entity Locked Artist

{
  "errors": {
    "base": [
      "Artist is locked"
    ]
  }
}

422: Unprocessable Entity Duplicate Name

{
  "errors": {
    "name": [
      "has already been taken"
    ]
  }
}

422: Unprocessable Entity Account Too New

{
  "errors": {
    "base": [
      "User can not yet perform this action. Account is too new."
    ]
  }
}

422: Unprocessable Entity Empty Name

{
  "errors": {
    "name": [
      "'' cannot be blank"
    ]
  }
}

422: Unprocessable Entity Name Too Long

{
  "errors": {
    "name": [
      "is too long (maximum is 100 characters)"
    ]
  }
}

422: Unprocessable Entity Group Name Too Long

{
  "errors": {
    "group_name": [
      "is too long (maximum is 100 characters)"
    ]
  }
}

422: Unprocessable Entity URL Too Long

{
  "errors": {
    "urls.url": [
      "is too long (maximum is 4096 characters)"
    ]
  }
}

Delete An Artist

DELETE https://e621.net/artists/{id}.json

Authorization Required

Janitor+ Required

This operation is idempotent.

Deleting an artist does not actually delete the artist, it sets is_active to false.

To "undelete" an artist, use Edit An Artist with artist[is_active]=true.

Path Parameters

Name	Type	Description
id*	Number	The ID of the artist to delete.

204: No Content Success

403: Forbidden Access Denied

{
  "success": false,
  "reason": "Access Denied"
}

404: Not Found Not Found

{
  "success": false,
  "reason": "not found"
}

Revert An Artist

POST https://e621.net/artists/{id}/revert.json

Authorization Required

Privileged+ Required If account is less than one week old.

Janitor+ Required If artist is locked or inactive.

This operation is idempotent.

version_id can be specified in the query, or the body.

Path Parameters

Name	Type	Description
id*	Number	The ID of the artist to revert.

Query Parameters

Name	Type	Description
version_id	Number	The ID of the version to revert to.

204: No Content Success

403: Forbidden Access Denied

{
  "success": false,
  "reason": "Access Denied"
}

404: Not Found Invalid Artist/Version ID

{
  "success": false,
  "reason": "not found"
}

422: Unprocessable Entity Account Too New

{
  "errors": {
    "base": [
      "User can not yet perform this action. Account is too new."
    ]
  }
}

422: Unprocessable Entity Inactive Artist

{
  "errors": {
    "base": [
      "Artist is inactive"
    ]
  }
}

422: Unprocessable Entity Locked Artist

{
  "errors": {
    "base": [
      "Artist is locked"
    ]
  }
}