Intuitive RESTful API design for logistics shipments availability, accept, allocation decision?

Question

I am trying to model APIs for

• Create shipments
• Fetch Available shipments (based on region preferences)
• Accept shipments (allows logged in user to accept multiple shipments on first come first serve basis )
• Allocate shipments (allows logged in user to allocate multiple shipments to driver, shipments must be accepted first)

What would the intuitive options for RESTFul API design for below scenarios? Does adding mine or my add any value or it is implicit that call is executed in the context of authenticated user?

Loading shipments This is straightforward by designing POST \shipments\

Available shipments

Option 1: \my\shipments
Option 2: \availableshipments
Option 3: \shipments?available=yes

Accept shipments

Option 1: \my\shipments\acceptance
Option 2: \acceptedshipments
Option 3: \shipments\acceptance

Verb: PUT

Body

    "id":
    [
       "10000023",    "10000025",   "10000025"
    ]

Allocate shipments

Option 1: \allocatedshipments
Option 2: \shipments\allocated

Verb: PUT

Body

"driverid": "12312",
"id" :  
 [
       "10000023",    "10000025",   "10000025"
 ]

Answer 1

How would you do that as a website?

Would you tell your users to submit some magic content to some magic URI, or would you offer a webpage where there is a form the user can fill out and just submit?

For a RESTful API, you would describe the pages you have in your application through Media Types, and let the client navigate through the use-cases using links and forms on its own. In this case the client would not need to know URIs, HTTP Methods or what to submit beforehand, because all that is discovered on the fly.

I'm just saying that, because you (or other people reading) may be not aware, that is how it was supposed to work. If you don't want to do that, and just want endpoints that do things, return some data, and all of that is hardcoded into the clients, then I guess there's no real difference in any of those options. You have to read the documentation and hardcode the URIs into the client, or even generate it automatically. Would different URIs make any difference there?