Skip to main content

Update an Opportunity

ENDPOINT
PUT https://api.codecoogs.com/v1/opportunities?id=
REQUEST BODY
{
"title": "Intern",
"link_url": "https://forms.gle/DZ5kgJWWuPsxHFBs8",
"term": "Fall 2026",
"website_viewable": false
}

Omitted fields are left untouched. updated_at is stamped by the API on every successful update.

URL Parameters


id Required

A UUID for the object.

Body Parameters


title Required

The opportunity's title.


link_url Conditional

The external URL applicants use to apply. Exactly one of link_url or linked_form_id must be given — supplying both, or neither, is rejected.


linked_form_id Conditional

A UUID referencing an internal form to route applicants to, instead of an external link_url.


description string Optional

The opportunity's description.


category string Optional

The card type. Must be one of Internship, Club Role, Project, Sponsor, Job, or Other.


icon_url string Optional

A URL to the icon shown alongside the opportunity.


term string Optional

The application window as shown on the website card.


opens_on string Optional

The date applications open.


closes_on string Optional

The date applications close.


expires_at string Optional

Internal auto-hide timestamp.


display_order integer Optional

Controls the order opportunities are returned in.


website_viewable boolean Optional

Whether the opportunity may be shown on the public website.


is_active boolean Optional

Whether the opportunity is live.

Returns

Returns a success status after successful opportunity update. This call returns a success status and an error message if something goes wrong.