Artists
Last updated
Last updated
GET
https://e621.net/artists.json
Name | Type | Description |
---|---|---|
GET
https://e621.net/artists/{nameOrID}.json
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.
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.
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
.
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.
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
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
limit
Number
page
String
nameOrID*
String
The name or ID of the artist to get.
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.
id*
Number
The ID of the artist to edit.
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.
id*
Number
The ID of the artist to delete.
id*
Number
The ID of the artist to revert.
version_id
Number
The ID of the version to revert to.