Blips

Search Blips

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

Query Parameters

Name	Type	Description
search[creator_name]	String	Search by the name of the creator of the blip.
search[creator_id]	String	Search by the id of the creator of the blip.
search[body_matches]	String	Search by the body of the blip.
search[response_to]	Number	Search by the blip the blip is responding to.
search[ip_addr]	String	Search by the ip address of the creator. See Search Parameters: search[ip_addr].
search[order]	String	The order of the returned results. One of: updated_at, updated_at_desc
search[id]	Number	See Search Parameters: search[id]
limit	Number	See Search Parameters: limit
page	String	See Search Parameters: page

200: OK Success (Results)

[
  {
    "body": "",
    "created_at": "0000-00-00T00:00:00.000-00:00",
    "creator_id": 0,
    "creator_name": "",
    "id": 0,
    "is_hidden": false,
    "response_to": null, // blip id
    "updated_at": "0000-00-00T00:00:00.000-00:00",
    "warning_type": null, // warning, record, ban
    "warning_user_id": null // user id
  }
]

200: OK Success (No Results) !!

// See https://github.com/e621ng/e621ng/issues/359
{
  "blips": []
}

Get Blip

GET https://e621.net/blips/{id}.json

Path Parameters

Name	Type	Description
id*	Number	The ID of the blip.

200: OK Success

{
  "body": "",
  "created_at": "0000-00-00T00:00:00.000-00:00",
  "creator_id": 0,
  "creator_name": "",
  "id": 0,
  "is_hidden": false,
  "response_to": null, // blip id
  "updated_at": "0000-00-00T00:00:00.000-00:00",
  "warning_type": null, // warning, record, ban
  "warning_user_id": null // user id
}

404: Not Found Not Found

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

Add Warning To Blip

POST https://e621.net/blips/{id}/warning.json

Authorization Required

Moderator+ Required

This operation is idempotent.

Path Parameters

Name	Type	Description
id*	Number	The ID of the blip to add a warning to.

Request Body

Name	Type	Description
record_type*	String	The type of warning to add to the blip. One of: warning, record, ban, unmark.

200: OK Success

{
  "html": "", // new blip html contents
  "posts": {}
}

403: Forbidden Access Denied

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

404: Not Found Not Found

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

500: Internal Server Error Invalid Warning Type

{
  "success": false,
  "message": "'TYPE' is not a valid warning_type",
  "code": "00000000-0000-0000-0000-000000000000"
}

Hide Blip

POST https://e621.net/blips/{id}/hide.json

Authorization Required

Moderator+ Required If the blip is not yours.

This operation is idempotent.

Path Parameters

Name	Type	Description
id*	Number	The ID of the blip to hide.

201: Created Success

{
  "body": "",
  "created_at": "0000-00-00T00:00:00.000-00:00",
  "creator_id": 0,
  "creator_name": "",
  "id": 0,
  "is_hidden": false,
  "response_to": null, // blip id
  "updated_at": "0000-00-00T00:00:00.000-00:00",
  "warning_type": null, // warning, record, ban
  "warning_user_id": null // user id
}

403: Forbidden Access Denied

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

404: Not Found Not Found

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

Unhide Blip

POST https://e621.net/blips/{id}/unhide.json

Authorization Required

Moderator+ Required

This operation is idempotent.

Path Parameters

Name	Type	Description
id*	Number	The ID of the blip to unhide.

201: Created Success

{
  "body": "",
  "created_at": "0000-00-00T00:00:00.000-00:00",
  "creator_id": 0,
  "creator_name": "",
  "id": 0,
  "is_hidden": false,
  "response_to": null, // blip id
  "updated_at": "0000-00-00T00:00:00.000-00:00",
  "warning_type": null, // warning, record, ban
  "warning_user_id": null // user id
}

403: Forbidden Access Denied

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

404: Not Found Not Found

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

Create Blip

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

Authorization Required

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

Request Body

Name	Type	Description
blip[body]*	String	The body of the blip.
blip[response_to]	Number	The ID of the blip to respond to.

201: Created Success

{
  "body": "",
  "created_at": "0000-00-00T00:00:00.000-00:00",
  "creator_id": 0,
  "creator_name": "",
  "id": 0,
  "is_hidden": false,
  "response_to": null, // blip id
  "updated_at": "0000-00-00T00:00:00.000-00:00",
  "warning_type": null, // warning, record, ban
  "warning_user_id": null // user id
}

403: Forbidden Access Denied

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

422: Unprocessable Entity Invalid Response To

{
  "errors": {
    "response_to": [
      "must exist"
    ]
  }
}

422: Unprocessable Entity Empty Body

{
  "errors": {
    "body": [
      "can't be blank"
    ]
  }
}

422: Unprocessable Entity Body Too Short

{
  "errors": {
    "body": [
      "is too short (minimum is 5 characters)"
    ]
  }
}

422: Unprocessable Entity Body Too Long

{
  "errors": {
    "body": [
      "is too long (maximum is 1000 characters)"
    ]
  }
}

422: Unprocessable Entity Account Too New

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

Edit Blip

POST https://e621.net/blips/{id}.json

Authorization Required

Admin+ Required If the blip is older than 5 minutes, or is not yours.

Path Parameters

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

Request Body

Name	Type	Description
blip[body]*	String	The new body of the blip.

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 Empty Body

{
  "errors": {
    "body": [
      "can't be blank"
    ]
  }
}

422: Unprocessable Entity Body Too Short

{
  "errors": {
    "body": [
      "is too short (minimum is 5 characters)"
    ]
  }
}

422: Unprocessable Entity Body Too Long

{
  "errors": {
    "body": [
      "is too long (maximum is 1000 characters)"
    ]
  }
}

422: Unprocessable Entity Blip Too Old

{
  "success": false,
  "message": "You cannot edit blips more than 5 minutes old",
  "code": null
}

Delete Blip

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

Authorization Required

Admin+ Required

Path Parameters

Name	Type	Description
id*	Number	The ID of the blip 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"
}