---
title: "Create a flag"
method: POST
path: "/flags"
tags: ["Flags"]
---

# Create a flag

`POST /flags`

## Request body

- FlagsCreate
  - `flag` object
    - `flaggable_type` string
    - `flaggable_id` integer
    - `flag` string
  - `flag_explanation` string, nullable
  - `fields` unknown

## Response `200`

A list of flags

- ResultsFlags
  - `total_results` integer, required
  - `page` integer, required
  - `per_page` integer, required
  - `results` Flag[], required
    - `id` integer, required — Unique auto-increment integer identifier.
    - `comment` string, nullable
    - `created_at` string, date-time
    - `created_at_utc` string, date-time, nullable
    - `flag` string
    - `flaggable_content` string, nullable
    - `flaggable_id` integer, nullable
    - `flaggable_type` string, nullable
    - `flaggable_user_id` integer, nullable
    - `resolved` boolean
    - `resolver_id` integer, nullable
    - `resolved_at` string, date-time, nullable
    - `updated_at` string, date-time, nullable
    - `updated_at_utc` string, date-time, nullable
    - `user` User, nullable
      - `id` integer, required — Unique auto-increment integer identifier.
      - `uuid` string, uuid
      - `created_at` string, date-time
      - `description` string, nullable
      - `faved_project_ids` number[] — Ordered list of IDs of projects the user has faved
      - `icon` string, nullable
      - `icon_url` string, nullable
      - `identifications_count` integer
      - `journal_posts_count` integer
      - `annotated_observations_count` integer
      - `last_active` string, date-time
      - `login` string
      - `monthly_supporter` boolean, nullable
      - `name` string, nullable
      - `observations_count` integer
      - `orcid` string, nullable
      - `preferences` object
        - `prefers_community_taxa` boolean — Whether the user allows the Community Taxon to be the taxon their observation is associated with
        - `prefers_observation_fields_by` 'anyone' | 'curators' | 'observer'
        - `prefers_project_addition_by` 'any' | 'joined' | 'none'
      - `roles` string[]
      - `site` Site, nullable
        - `id` integer, required — Unique auto-increment integer identifier.
        - `icon_url` string — URL of an icon image for the site
        - `locale` string, nullable — Default language code for users of this site
        - `name` string — Full name of the site
        - `place_id` integer, nullable — Integer ID of the default search place for this site
        - `site_name_short` string, nullable — Short name for this site
        - `url` string
      - `site_id` integer, nullable
      - `spam` boolean
      - `species_count` integer
      - `suspended` boolean
      - `updated_at` string, date-time
    - `user_id` integer
    - `uuid` string, uuid, nullable

## Other responses

- `default` — Unexpected error

---

[API](https://skmtc.net/inaturalist/apis/inaturalist-version-2-api.md) · [All operations](https://skmtc.net/inaturalist/apis/inaturalist-version-2-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/inaturalist/inaturalist-version-2-api/revisions/f739db716aaf/schema)