artists

Prepare a new artist

Changed on

Returns an unsaved artist built from the supplied attributes. Persisted fields such as the ID and timestamps are null.

get/artists/new.json

Request

  • Base URL: https://e621.net
  • URL: https://e621.net/artists/new.json
  • Auth: one of:
    • none
    • HTTP basic
    • API key in query parameter login and API key in query parameter api_key

Query parameters

artist[name]string

The artist's tag name to prefill

artist[other_names]string

Space-separated alternative names to prefill

artist[other_names_string]string

Space-separated alternative names to prefill

artist[group_name]string

The artist group or circle name to prefill

artist[url_string]string

Newline-separated artist URLs to prefill

artist[notes]string

The artist wiki page body to prefill

artist[linked_user_id]integer

The ID of the linked user account (staff only)

artist[is_locked]boolean

Whether the artist page is locked (staff only)

Response

An unsaved artist

idinteger required

The unique ID of the artist

namestring required

The artist's tag name

creator_idinteger required

The ID of the user who created the artist entry

is_activeboolean required

Whether the artist is active

is_lockedboolean required

Whether the artist page is locked for editing

other_namesstring[] required

Alternative names for the artist

group_namestring required

The name of the artist group or circle

linked_user_idinteger nullable required

The ID of the linked user account

created_atstring date-time required

The time when the artist was created

updated_atstring date-time required

The last time the artist was updated

Changes